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Preface to an "Introduction to G Programming" 
The creation of this content was supported in some part by NSF grant 
0538934. 


The Internet, personal devices and multicore computers have greatly 
changed and enhanced our lives by allowing us to access information and 
entertainment on-demand anytime, anywhere. While these technologies are 
great on their own merit, the reality is that in order to reap the benefits, 
someone has to program these devices to develop useful applications. 


Historically, text-based high-level programming languages provided the 
first productive alternative to develop targeted applications. As more 
networked computing platforms enter the mainstream, the programming 
complexities of text based languages becomes a limiting factor, especially 
for domain experts who are typically not programming or computer science 
experts. The G programming language provides the next generation 
programming alternative allowing users to develop interactive parallel 
programs whether they have extensive programming experience or not. It’s 
graphical syntax and constructs allow researchers, teachers, students and 
even children to program complex devices and systems in minutes rather 
than hours, days or even months. 


G is a data flow graphical programming language. Originally designed to 
address test and measurement needs, its general purpose programming 
attributes has been applied in telecommunications, biomedical, aerospace, 
environmental and many other industries. In general, G is used in Science, 
Technology, Engineering and Math (STEM) projects and programs but is 
not limited to STEM. 


The book was written to help the user learn the G programming syntax and 
begin developing G programs quickly and easily. Although familiarity with 
programming concepts could help learning G, the book assumes the user 
has had no previous exposure to any programming languages. Therefore, to 
avoid confusion, no pseudo-code or syntax comparisons are made with text- 
based programming languages. All examples in this book are working 
graphical examples and have been tested thoroughly. Chapter 1 is an 
introductory tutorial providing a reference for beginners and seasoned 
programmers alike. Subsequent chapters provide more details on the G 


syntax building up to the development of parallel programs that run on 
multicore platforms. 


This book is not an introduction to programming, style guide, debugging or 
to development environments. It is strictly a concise G syntax. Additionally, 
the user must have access to National Instruments LabVIEW and be 
familiar with LabVIEW basics. Nonetheless, the user should be able to read 
along to learn and understand the benefits of G programming. 


As one of the original LabVIEW development team members, developing 
G programs has been a pleasant and productive experience. It is the author’s 
sincere hope that the user finds G programming and interesting endeavor as 
well. 


Lalo Pérez, Ph.D. 


About the Author 


Dr. Eduardo "Lalo" Pérez is one of the original LabVIEW development 
team members responsible for the design, deployment and optimization of 
the Digital Signal Processing and Data Analysis Libraries still being used 
today. 


Dr. Pérez has nearly 30 years of engineering programming experience and 
nearly 20 years designing and implementing digital signal processing 
software architectures for the deployment of multimedia, communications 
and biomedical real-time applications. He has extensive experience in large 
enterprises - where he successfully deployed global multimedia networks 
and services for AT&T and Ernst & Young - as well as startups where he 
forged strategic alliances with Intel, Microsoft, Samsung and Texas 
Instruments to accelerate adoption of audio-visual services over IP. Dr. 
Pérez’ other accomplishments include: member of the first ever live video 
webcast team over ISDN in 1994, first commercial DSL live IP broadcast in 
1999, provided nearly 3 years of webcasting services for Broadcast.com 
(now Yahoo! Broadcasting Services) with 100% success rate, team member 
at SBC Communications that launched SBC Internet Services and DSL 
services and provided guidance for deployment of early Internet multimedia 
communities. 


Dr. Pérez holds a variety of patents on high quality video encoding, 
compressive data acquisition, multirate media processing, remote 
computing and streaming delivery mechanisms. 


A native from Mexico, he immigrated to the U.S. at the age of 18 to pursue 
higher education. He received his B.S., M.S., and Ph.D. in Electrical and 
Computer Engineering in the areas of Telecommunications, Image 
Processing, and Real-Time Digital Imaging Systems, respectively, all from 
the University of Texas at Austin. 


Dr. Pérez was a member of the 1976 Mexican Olympic Swimming team. 


Introduction to G Programming 
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G is a high level, data-flow graphical programming language designed to develop applications that are 
e Interactive 
e Execute in Parallel 


e Multicore 


The program is a block diagram edited in the Block Diagram programming window. 


G Block Diagram 


The program input data and results are manipulated and displayed in the Front Panel window. 


Amplitude 


STOP. 


G User Interface 


Hello Graphical World 


The first program is to display the text “Hello graphical interactive parallel multicore world” in the Front 
Panel window. 


Right click on the Block Diagram window and select String Constant from the Functions >> 
Programming >> String menu. 


Drag and drop the String Constant onto the Block Diagram window as show in [link]. 
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String Constant Empty String 


String Constant 


Type in “Hello graphical interactive parallel multicore world.” in the String Constant. 


Hello graphical interactive 
parallel multicore world, 


"Hello... 
world" 
String 

Constant 


Right click in the Front Panel window and select a String Indicator from the Controls >> Modern >> 
String & Path menu. 


Controls 


| string & Path 


String Control String Indicator 


[ Debug Dep| 


Select String Indicator 


Drop it into the Front Panel window. 


String 
Indicator 


Return to the programming window. Notice the string terminal corresponding to the string indicator in 
the Front Panel window. As you approach the string constant from the right, the wiring terminal is 
highlighted and the pointer turns to wire spooler. 


String 
Hello graphical interactive ‘ 
parallel multicore world. = 


Wiring the G Diagram 


Click the “Hello graphical interactive parallel multicore world” terminal and then click on the String 
Indicator triangular terminal to wire the terminals. 


String 
Hello graphical interactive R 
parallel multicore world, Ieee 
Wired G Block 
Diagram 


Save your program as Hello, World.vi. Return to the Front Panel window. Click the run button (). You 
have successfully completed and executed your first G program. 


Hello graphical interactive 
parallel multicore world, 


Hello, World G 
Program 
Executed 


Arithmetic Expressions 
The next program converts degrees from Fahrenheit to Celsius using the formula 


C = 3(F - 32). 


In the Block Diagram window, select the subtract, multiply and divide from the Functions >> 
Mathematics >> Numeric menu 
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Numeric Operations 


Wire the subtract, multiply and divide functions as shown in [link]. 


Subtract, 
Multiply and 
Divide 


Right click on the upper left terminal of the subtract function and select Create >> Control from the 
pop-up menu. 


Visible Items > } 
Help 

Examples 

Description and Tip... 
Set Breakpoint 


Numeric Palette 


Constant 


Indicator 


Replace 


Properties 


Create Control 


Re-label x as Fahrenheit and wire the terminal as shown in [link]. 


Fahrenheit 
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Fahrenheit Input Control 


Right click on the lower left terminal of the subtract function and select Create >> Constant and type 
32.0. 


Fahrenheit 
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Fahrenheit Numeric 
Constant 


Repeat the process to generate numeric constants for the multiply and divide function with 5.0 and 9.0 
respectively. 


Fahrenheit 


Fahrenheit Numeric 
Constants 


To complete the program, right click on the right terminal of the divide function and select Create >> 
Indicator. Re-label x/y as Celsius. The final diagram is shown in [link]. 


Fahrenheit 


Celsius 


Fahrenheit to Celsius G 
Diagram 


Switch to the Front Panel window to run the program. Save the program as Celsius.vi. Try various 
Fahrenheit values to see the corresponding Celsius values. You have successfully finished a Fahrenheit 
to Celsius calculator. 
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Functions 


Click on empty space and drag to select the entire diagram. 
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Select G Block Diagram 


The selected diagram is highlighted as shown in [link] 


Fahrenheit 


Selected G Block Diagram 


From the Edit menu select Create SubVI to create a G function. The resulting diagram is shown in 
[ink]. 


View Project 


Undo Window Size 


Creating 
a 
Function 


From the File menu select Save All and save the Untitled function as Fahrenheit to Celsius.vi. 


Fahrenheit Celsius 
fe 


Diagram with 
Function 


Open the Fahrenheit to Celsius.vi by double clicking on the icon. Right click on the icon editor (upper 
right corner) and select Edit Icon... 


VI Properties 


Show Connector 


Find All Instances 


Edit Icon 


This pops-up the Icon Editor. Edit the function’s icon. 


B&W Copy from: 


Black & White 
Cel 
16 Colors 
16 Colors 
[ 256 Colors | 
(J Show Terminals 
. 
256 Colors 
Celsius || 
= = fad 
Cel 
Icon Art Glossary on ni.com 


Icon Editor 


After editing the icon, the function’s icon is shown in the upper right corner of the Front Panel window. 
Save the function, plug in various input values and run the function. Save the function. 


Fahrenheit to Celsius.vi... SE 


Edited Icon 


Close the Fahrenheit to Celsius function and return to the Celsius Block Diagram windows. The 
Celsius diagram reflects the updated Fahrenheit to Celsius icon 


Fahrenheit Celsius 


Function Calling 


Case Selection 


This program determines if a year is a leap year or not. A leap year is divisible by 4 but not by 100, 
except when it is divisible by 400. A number x is divisible by a number y if the remainder of x/y is 
identical to zero, i.e. Rem(x/y)=0 is true therefore 

Equation: 


Leap Year = {Rem (Year/4) = 0 And Not(Rem (Year/100) = 0)} Or Rem (Year/400) = 0 


where And, Or and Not are Boolean operators. 

For example: 

1900 is not a leap year because it is divisible by 100 

1970 is not a leap year because it is not divisible by 4 

1980 is a leap year because it is divisible by 4 but not by 100 
2000 is a leap year because it is divisible by 400 


Start a new G program and right click on the Block Diagram window. Go to the Functions >> 
Programming >> Numeric menu in the Block Diagram window. 
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Divide Quotient &R... Decrement 


Quotient & 
Remainder 
Function 


Select three copies of the Quotient & Remainder function and three numeric constants. Type in 4, 100 
and 400 for the numeric constants and wire these constants to the lower input terminal (corresponding to 
the dividend) of the Quotient & Remainder function. 


Leap 
Year 
Numeric 
Constant 
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From the Functions >> Programming >> Comparison menu, select 2 copies of the Equal to Zero 
function and one copy of the Not Equal to Zero function. 
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Equal To 0? Not Equal To 0? 


Comparison 
Functions 


Organize the comparison operations as show in the diagram. 


From the Functions >> Programming >> Boolean menu select the AND and OR operators 
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Boolean 
Operators 


Place the Boolean operators as shown in [link]. 


Q&R, Comparison & 
Boolean Functions 


From the Functions >> Programming >> Structures menu, click on the Case Structure. 
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For Loop § While Loop Timed Structu,.. Case Structure 


Case Structure 


Click and drag on the Block Diagram window to create the Case Structure. 
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The True diagram option is indicated at the top of the case structure. 


100 


Created Case Structure 


Drop a string constant and type “Is a Leap Year”. 
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True Case Editing 


Click on the down arrowhead next to the True label and select the False option. 


Selecting the False Case 


Drop another string constant and type “Is not a Leap Year”. 


Ps Face =P 


False Case Editing 


Go to the Front Panel window and place a numeric input and an output string. Re-label the numeric input 
to Year and the output string to Message. 


Leap Year GUI 


Right click on Year and select Representation >> [32 from the numeric pop-up menu. 
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Find Terminal 
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32-Bit Integer Numeric 


Arrange the Year and Message terminals in the Block Diagram window as shown in the figure. 
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Unwired Leap Year Diagram 


Wire the OR operator is to the “?” in the case structure and the string constant “Is not a Leap Year” is 
wired to Message. 
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Leap Year False Case 


Select the True option and Wire the “Is a Leap Year” string constant to the output terminal of the Case 
Structure. 


Leap Year True Case 


Save the program as Leap Year.vi, enter Year values and run the program to determine whether the 
value of Year is that of a leap year or not. 


é 2000 Is a Leap Year 


Leap Year Program 


Arrays 


Right click on the Front Panel window and select Array from the Controls >> Modern >> Arrays, 
Matrix & Cluster menu, and drop an array onto the Front Panel window. The array structure consists of 
an index or element offset (left portion of the structure) and the array elements (right portion of the 
structure). When the array structure is placed on the Front Panel window, the data type of the array is 
undefined as indicated by the grayed out portion of the array. 
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Arrays 


To define the array data type, drag and drop a data type onto the array structure. For instance, to create an 
input array of numbers, place Numeric Control into the array structure. 


Controls 


Creating a Numeric Array 


At this point, the numeric array is an Empty or Null array because no elements of the array have been 
defined. This is indicated by the grayed out numeric control within the array structure. 
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Empty 
Numeric 


Array 


Define elements of an input array by selecting the offset and entering its value. For instance, at offset = 
4, enter the value 0.0. This defines Numeric Input Array as {0, 0, 0, 0, O}. 


Defining 
Numeric 
Array 
Elements 


An output array is created similarly to an input array with the exception that an output data type needs to 
be dropped into the array structure. 


Creating Output Numeric 
Arrays 


For Loop 


This program converts an array of Fahrenheit values to Celsius. Create numeric input and output arrays 
and label them Fahrenheit and Celsius respectively. In the Fahrenheit array enter the values 0, 20, 40, 
60, 80, 100, 120, 140, 160, 180 and 200 at offsets 0 through 10 as shown in [link]. 


Numeric Input and Output 
Arrays 


Right click in the Block Diagram window, navigate to Programming >> Structures and click on For 
Loop. 
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For Loop Structure 


Click and drag to create the For Loop as shown in [link] and [link]. 
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Creating For Loops 


Fahrenheit Celsius 


For Loop 


Right click inside the For Loop and select Select a VI... from the pop-up menu. Find the Fahrenheit to 
Celsius.vi and click OK. Drop the function inside the For Loop. 


Fahrenheit Celsius 
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Function in Diagram 


To complete the program, wire the Fahrenheit input array to the input terminal of the Fahrenheit to 
Celsius function and wire the output terminal of the Fahrenheit to Celsius function to the Celsius 
output array. 


Wired Function in 
Diagram 


This program uses the For Loop to select each element in the Fahrenheit input array, converts that 
value to Celsius and saves the results in the Celsius output array. Save the program as Fahrenheit to 
Celsius For Loop.vi and run the program. 


Fahrenheit to Celsius 
Arrays 


The Celsius output array contains: Celsius = {-17.7778, -6.6667, 4.44444, 15.5556, 26.6667, 37.7778, 
48.8889, 60, 71.1111, 82.2222, 93.3333} 


While Loop 


The next program will generate Fahrenheit values and convert them to Celsius until a condition is met to 
stop the iterations in a While Loop. In the Block Diagram window, select the While Loop structure by 
clicking on it from the Functions >> Programming >> Structures menu. 


Click and drag to create the While Loop structure. 
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Creating a 
While Loop 


While Loop 


In the Front Panel window, create two numeric output arrays. Label them Fahrenheit and Celsius. 


Numeric 
Output Arrays 


Re-arrange the diagram as in [link]. 
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While Loop Diagram 


From the Functions menu, select Multiply function and a couple of numeric constants. Type in 20.0 and 
300.0 for the numeric constants. Select the Fahrenheit to Celsius.vi and drop it inside the While Loop. 
Re-arrange the diagram to look like [link]. 
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Generating Fahrenheit 
Values 


From the Functions >> Programming >> Comparison menu select the Greater or Equal operator. 


| ¥ Programming 
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Greater or Equal 
Function 


Wire the While Loop components as shown in [Link]. 


Fahrenheit 


Generating Fahrenheit 
Values & Stop Condition 


Wire the output of the Multiply operation to the Fahrenheit and the output of the Fahrenheit to Celsius 
function to the Celsius numeric output arrays. The connections between the While Loop and the 
Fahrenheit and Celsius arrays are broken (see [|ink]). 
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Broken Wires 


To repair the broken connections, roll over the mouse pointer to the Loop Tunnel. 
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Loop Tunnel 


Right click on the Loop Tunnel and select Enable Indexing from the pop-up menu. 


Fahrenheit 


Enable Indexing 


Replace with Shift Register 


Enable Loop Indexing 


This enables values to accumulate and store the results into an array. 


Repeat for the Celsius array. 


Fahrenheit 


Broken Wire Repaired 


Each iteration of the While Loop in this program generates an i x 20 Fahrenheit value and converts it to 
Celsius. The While Loop stops iterating when the generated Fahrenheit value is greater than or equal to 
300. The resulting arrays are stored in the Fahrenheit and Celsius numeric output arrays. 


Save the program as Fahrenheit to Celsius While Loop.vi and run it. The program generates the 
following results: 


Fahrenheit 


Fahrenheit to Celsius While 
Loop 


Fahrenheit = {0, 20, 40, 60, 80, 100, 120, 140, 160, 180, 200, 240, 260, 280, 300} 


Celsius = {-17.7778, -6.6667, 4.44444, 15.5556, 26.6667, 37.7778, 48.8889, 60, 71.1111, 82.2222, 
93.3333, 104.444, 115.556, 126.667, 137.778, 148.889} 


Fahrenheit and 
Celsius Arrays 


Graphs 


Using the previous G program example, we will now visualize the results by adding a graph to the Front 
Panel windows. Right click on the Front Panel window. Select XY Graph from the Controls >> 
Modern >> Graph menu. 
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XY Graph Selection 


Drop the XY Graph in the Front Panel window. Double click on the x and y axis labels and rename 
Time to Fahrenheit and Amplitude to Celsius. 


Fahrenheit XY Graph 
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XY Graph in Front Panel window 


The Block Diagram window contains the XY Graph terminal. 


Fahrenheit 


XY Graph Terminal in Diagram 


Select Bundle from the Functions >> Programming >> Cluster, Class & Variant menu 
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Bundle Operator 


Drop it on the diagram as shown in [link]. 
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Wire the Fahrenheit and Celsius results to the input Bundle terminals and the output Bundle terminal 
to the XY Graph. 


Save the program and run it. The resulting graph is shown in the figure below. 
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Fahrenheit XY Graph 
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Interactivity 


This G program shows how G allows programmers to develop interactive programs. Create the following 
G program and wire it as shown in the figure below. 


Creating Interactive 
Programs 


In the Front Panel window, from the Functions >> Modern >> Numeric select the vertical pointer slide. 
From the Functions >> Modern >> Graph select Waveform Chart. 
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Vertical Pointer Slide and Waveform Chart 


Re-label the vertical pointer slide as Amplitude and the waveform chart as Sine Wave. Re-arrange to 
GUI to look like the figure below. 
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Right click on Sine Wave and select Properties from the pop-up menu. 
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Selecting Chart Properties 


Select the Scales tab and change Maximum to 1023. Sine Wave will display 1024 samples. 
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Click on the down arrow located to the right of Time (X-Axis) and select Amplitude (Y-Axis). 
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Selecting Y-Axis 


De-select Autoscale and change the Minimum and Maximum values to -10 and 10. Click OK. 
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De-Selecting Autoscale 


In the Block Diagram window, re-arrange the Amplitude and Sine Wave terminals and finish the 
program as shown in [link]. 
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Diagram 


Scroll the mouse pointer over the Loop Control... 
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Loop Condition 


And right click on the Loop Control and from the pop-up menu select Create Control. 
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Create Loop Control 


A stop terminal is created... 


Sine Wave 


Interactive G Program 


With the corresponding stop Boolean input control. Save the G program as Interactivity.vi. 
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Run the G program. 
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Interactive Program 


While the program is running, change the Amplitude and watch the graph update to reflect the 
interactive changes. 
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Interactive Program 


To end the G program, simply click on the stop button. 


Congratulations. You have successfully completed and executed your first interactive G program. 
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Interactive Program 


Parallel Programming 


Save a copy of Interactivity.vi as Parallel Programming.vi. Select the while loop as shown in [link]. 
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From the menu select Edit >> Copy. 
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Copy Selected Diagram 


Create a copy of the while loop and its contents by selecting Edit >> Paste. Organize the diagram as 
shown in the figure below. 


Sine Wave 2 


Paste Diagram 


Go the Front Panel window and organize the input and output controls as shown in the figure below. 
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Congratulations!!! You have just completed your first parallel interactive program using G. Save the 
program, run it and interact with it. To end this program click on stop and stop 2. 
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Parallel Interactive G Program 


Multicore Programming 


Save a copy of Parallel Programming.vi as Multicore Programming.vi. If you have a multicore 
computer, CONGRATULATIONS!!! You have just completed your first multicore G program. 
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Interactive Multicore G Program 


Polymorphism 
This program shows the polymorphic properties of G. Create the G program shown below. 


Notice that the Subtract and Multiply operations allow arrays to be wired in the G program. 
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Exponential and Logarithmic Functions 
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Arrays and Clusters 
The creation of this content was supported in some part by NSF grant 
0538934. 


To create an array in G, right click on the Front Panel window and select 
Array from the Controls >> Modern >> Arrays, Matrix & Cluster 
menu, and drop the array structure onto the Front Panel window to create an 


array. 
\-y Modern 


L Array, Matrix & Cluster 
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Array Cluster 


Array Structure 


The array structure consists of an index or element offset (highlighted left 
portion of the array structure) and the array elements (right portion of the 
structure). When the array structure is placed on the Front Panel window, 
the data type of the array is undefined as indicated by the grayed out portion 


Index and 
Elements of an 
Array 


To define the array data type, drag and drop any data type, such as numeric, 
Boolean, string or cluster structure, onto the elements portion of the array 
structure. 


Creating 
Arrays 


At this point, the newly defined array is an Empty or NullArray because 
no elements of the array have been defined. This is indicated by the grayed 
out data type within the elements array structure. 
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Empty 
Arrays 


To define elements of an input array, select the element’s index and enter 
the appropriate value. [link] defines a numeric array with one element at 
index 0. 


Defining 
Array 
Elements 


G arrays are zero-based. The last element index of an N element array is N- 
1. [link] and [link] are those of a 10 element array. 
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Last Array 
Element 


Undefined 
Nth Element 


An output array is created similarly to an input array with the exception that 
an output data type needs to be dropped into the array structure. 


Input and Output Arrays 


Multidimensional Arrays 


To create multidimensional arrays, click on the array’s index and select 
Add Dimension from the menu. 


[link] shows a 2-dimensional array. 
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Array Operators 


Clusters 


Clusters allow users to create compound data types by aggregating various 
and different data types into a single unit. 


Empty 
Cluster 


Select the various data types and drag them onto the cluster structure. [link] 
shows an Error Cluster consisting of a Boolean Error, a numeric ID and a 
string Message data types. 


Out ofrange 


Cluster 
Example 


Cluster Operators 
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Data Flow Control 
The creation of this content was supported in some part by NSF grant 
0538934. 


Case Structure 


The case structure allows data to flow based on a integer, Boolean or string 
matching condition. The case executed is selected based on the data wired 
to the Case Selector. 


Selector 


Selector Label 


Case Structure 


Boolean Selection 


In the Front Panel window, select a Boolean control and an output string. 


Case Selection 
User Interface 


Arrange the diagram to look as in [Link]. 


Case Selection G 
Diagram 


In the True case, add a string constant containing True Case. 


Boolean 
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True Case Diagram 


To select the False case, click on the selector label down arrow and select 
False from the pop-up menu. You can also cycle through the cases by 
clicking the next (right) or previous (left) arrows. 


Boolean 


Selecting False Case 


In the False case, add a string constant containing False Case. 
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False Case Diagram 


Wire the string constant in the case structure to the output string terminal. 
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Boolean 


Wiring Case 
Structures 


Select the True case and wire the string constant to the case structure 
tunnel. Complete the diagram as shown in [link]. 


Completed Case 
Diagram 


It is important to note that all instances in a case structure must be wired to 
enable data to flow from the case structure. 


In the Front Panel window, toggle the Boolean input control and run the 
program. 
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False Selection 


True Selection 


Multicase Selection 


Select an Integer 32 numeric input and an Integer 32 numeric output and 
label them Selector and Case respectively. 
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Multicase GUI 


In the Block Diagram window, create a case structure, select the False case 
and arrange the terminals as shown in [Link]. 


Selector 


Multicase 


Wire the Selector numeric control to the case selector on the case structure. 
The selector label reflects the diagram update. 


Multicase Selector 


In the 0, Default case, add a numeric constant and leave its value as 0. 


Default Case 


Using the selector label, select case 1. Add a numeric constant, enter 1 and 
wire it to the case tunnel. The resulting diagram is shown in [link]. 


Right click anywhere in the case structure and select Add Case After from 
the pop-up menu. 
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Adding Cases 


Case 2 is added after case 1. Add a numeric constant, enter 2 and wire it to 
the case structure tunnel. 


[link] shows the results of running this simple case selection programs for 
Selector set to 0, 1, 2 and 3 respectively. 


Multicase Selection Program 


For Loop 


The For Loop structure repeatedly executes the diagram within the 
structure. The Loop Count specifies the number of times the loop contents 
must be executed and the Loop Iteration indicates which iteration is 
currently being executed. 
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For Loop 
Structure 


The Loop Count and Loop Iteration are of Integer 32 data types. If the 
Loop Count is set to N, then the Loop Iteration value range is from 0 to 
N-1. This is illustrated in [link] and [link]. 
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Final Loop 
Iteration 


Shift Registers 


Shift Registers allow the preservation of intermediate results between 
sequences of iterations. 


Shift 
Registers 


Result at Result at 
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Shift Registers 


To add a Shift Register, right click on the For Loop structure and select 
Add Shift Register from the pop-up menu. 
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Help 


Add Shift Register 


Adding Shift 
Registers 


To add elements to the shift register, right click on the shift register and 
select Add Element from the pop-up menu. 


Help 


Add Element 
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To illustrate the use of the shift registers, the following example computes 
the Fibonacci number Fib(n). 
Equation: 


0, n=0 
Fib(n) = 1, a 
Fib(n — 1) + Fib(n— 2), n>1 


In the Front Panel window, select an integer 32 numeric input and output 
controls and labeled them n and Fib(n) respectively. Arrange the diagram 
as shown in [link]. 


Shift Register Example 


Add a 0 and 1 numeric constants to initialize the elements of the shift 
register and wire them to the i-1 and i-2 elements respectively. Add the add 
operator in the for loop and complete the program wiring as shown in [link]. 


Fibonacci G 
Program 


For n = 0, the for loop iterates 0 times and passes 0 to Fib(n), therefore 
Fib(0)=0. For n = 1, the for loop the values in i-1 and i-2 shift register 
elements are added (0+1) and saved in the i shift register element (1). Since 
the loop iterates once only, the resulting value is passed to Fib(n), therefore 
Fib(1)=1. For n = 2, the first iteration produces the value of 1. Prior to the 
next and final iteration, the values are shifted in the register as follows: 


The value in the i-2 shift register element is discarded 


The value in the i-1 shift register element is shifted to the i-2 shift register 
element 


The value in the i shift register element is shifted to the i-1 shift register 
element 


To start the 2" and final iteration, the i-1 shift register element contains 1 
and the i-2 shift register element contains 0. These are added to produce 1, 
which is passed to Fib(n) and, therefore, Fib(2)=1. This process is repeated 
for values of n > 2. 


Save this program as Fibonacci.vi. [link] shows the result of Fib(8). 


Fib(8) = 21 


Auto-Indexing 


Auto-indexing allows input array elements to be operated on and output 
array elements to be aggregated automatically in a for loop. It is not 
required to wire the Loop Counter. The for loop automatically reduces the 
array dimensionality by one. 
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Auto-Indexed Tunnel 
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For Loop Auto- 
Indexing 


Disabling Auto-Indexing 


It is sometimes necessary to disable auto-indexing. In this example, the For 
Loop is used to scan the elements of the array taking advantage of the auto- 
indexing feature. However, the result is a single number. Wiring the result 


through the For Loop with auto-indexing enabled results in a broken data 
type wire. 
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Broken Auto-Indexing 


To disable auto-indexing, right click on the target Auto-Indexed Tunnel 
and select Disable Indexing from the pop-up menu. 
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Disabling Auto- 
Indexing 


The final diagram with the Auto-Indexed Tunnel disabled is shown in 
[link]. 


Disabled Auto- 
Indexing 


While Loop 


The While Loop conditionally iterates executing the statements within the 
structure. The Loop Condition establishes whether the loop iterates or 
terminates. The Loop Iteration is a zero-based iteration execution 
reference similar to the For Loop. 


Loop 
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While Loop 
Structure 


Loop Condition 


Stop if True 


The default loop condition is to continue if the Boolean condition is False 
(or stop if True). The while loop in [link] will iterate while Iterations is 
less than Loop Iteration is False or, equivalently, will stop iterating when 
Iterations is less than the value in Loop Iteration. 


Iterations 


Stop If True 


Continue if True 


At times it is more convenient to let the while loop iterate while the 
condition is True. To change the loop condition, right click on the loop 
condition icon and select Continue if True from the pop-up menu. 
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Changing Loop 
Condition 


[link] shows the Loop Condition set to Continue if True. 


Iterations 


Continue If True 


Shift Registers 


Programmatically, while loop shift registers are identical to for loop shift 
registers. Refer to [link] for the discussion. However, an example is 
provided to illustrate the use of shift registers in while loops. 
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In the following example, Euler’s number e is computed to the specified 
accuracy using the infinite series 


Equation: 
nae nae 1 1 1 1 

e= —=14+ De — =14+—4+ 24+ 4+... = 2.7182818284 
nao n! ef 1! 62! 8! 


Notice that two shift registers keep track of the factorial and the sum. Also 
notice the dot in the multiplication. This is because the loop iteration is an 
integer 32 data type and the input from one of the shift registers is double 
precision numeric. The dot represents that the integer 32 data type has been 
coerced into a double precision number. 


Computing e 


Save the program as e.vi. The result of running this program is shown in 
[link]. 
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Enabling Auto-Indexing 


By default, while loops are auto-indexed disabled. In order for while loops 
to process and generate arrays, the loop tunnel must be enabled to auto- 
indexed arrays. 


Disabled Auto- 
Indexing 


To enable auto-indexing, right click on the loop tunnel and select Enable 
Indexing from the pop-up menu. 
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Enabling Auto- 
Indexing 


In this example the while loop appropriately generates a 1,000 element 
numeric array with random numbers. 
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Sequence 


Although G was designed to easily develop interactive, parallel programs, it 
is sometimes necessary to execute diagrams in sequential order. The 
sequence structure allows G diagrams to execute sequentially. 


The following examples time in milliseconds (ms) the execution of a G 
diagram. The sequence of events is get a start time stamp, execute the 
diagram, get stop time stamp and take the difference between the stop and 
Start times to determine the execution time. 


Execute Execute 


First Next 


Sequence 
Structure 


Flat Sequence 


Flat Sequences always execute left to right. A Flat Sequence structure 
starts with a single frame and allows a user to visualize the diagram 
sequences. 


Sequenc 
e Frame 


To add frames to a sequence, right click on the sequence structure and select 
either Add Frame After or Add Frame Before from the pop-up menu 
according to the program’s needs. 
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Add Frame After 
Add Frame Before 
Delete This Frame 


Adding 
Sequence 
Frames 


Add two more frames to the sequence structure to get a three frame 
sequence as shown in [link]. 


Three Frame Sequence 


From the Functions >> Programming >> Timing menu select Tick Count 
(ms) function. 
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Tick Count Function 


Drop the Tick Count (ms) function in the first (left most) frame of this 
sequence. Make a copy of the Tick Count function and place it on the third 
(right most) frame as shown in [Link]. 


Start and Stop 
Tick Counts 


Add a For Loop that iterates 5,000 times to the second frame. Add a 
subtract operator, an unsigned integer 32 output and complete the program 
as shown in [link]. The execution of this program shows the time in 
milliseconds it took for the 2"¢ sequential frame to execute. 
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Stacked Sequence 


A Stacked Sequence provides a more compact representation of program 
sequences. It is programmatically identical to the Flat Sequence with the 
exception that a Sequence Local enables data to flow to subsequent frames. 
Additionally, as frames are added, a Sequence Selector provides access to 
the desired frame (see [link]). 


Stacked 
Sequenc 
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For this timing example, start with a Stacked Sequence and add 3 more 
frames. The sequence frames are labeled 0, 1, 2 and 3 and will execute in 
that order. 


Four 
Frame 


Stacked 
Sequenc 
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Go to the first frame (frame 0) and add a Tick Count (ms) function. Right 
click on the sequence structure and select Add Sequence Local from the 
pop-up menu. 


Adding 
Sequenc 
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Add Sequence Local 
Add Frame After 
§ Add Frame Before 


Adding 
Sequence 
Locals 


The Sequence Local is shown as an undefined tunnel. Wire the Tick Count 
(ms) function to the Sequence Local to define the tunnel data type and data 


flow. Data can now flow from frame 0 to the other frames as needed. 


Sequenc 
e Local 


Sequenc 
e Local 


Go to the next frame sequence (frame 1) and enter the program to be timed. 
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to Time 


Go to the third frame of the sequence (frame 2), add a Tick Count (ms) 
function, add another Sequence Local and wire the Tick Count (ms) to the 
new Sequence Local. The wired sequence frame is shown in [link]. 


Go to the last frame (frame 3) and add a Subtract function. Wire the 
Sequence Locals from frame 2 and frame 0 to the Subtract function as 
shown in [link]. To complete the diagram, wire the output of the Subtract 
function to the unsigned integer 32 output. 


Stacked 
Timing G 
Program 


It is important to note that the programs in [link] and [link] are 
programmatically identical. 


Functions 
The creation of this content was supported in some part by NSF grant 
0538934. 


Any G program can become a function. Three operations must be done: 


1. Edit connecting input and/or output terminals 
2. Edit the icon (optional but recommended) 
3. Save the G program 


Connectors 
Open the Fibonacci.vi for this example. 


On the Front Panel window, right click on the icon located on the right 
upper corner of the window and select Show Connector. 
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Show Connector Pane 


This brings up the connector pane as shown in [link]. 
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Connector Pane 


Right click on the connector pane and select Patterns. A menu with 
connector patterns is presented from which you can select the appropriate 
pattern. For this example select the pattern highlighted in [link]. 
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Select Connector Pattern 


Click on the connector terminal followed by a click on the input or output 
control to which the terminal is to be associated. In [link], the left connector 
terminal is associated with the numeric input control n. 


File Edit View Proje 


Associating 
Terminals 


Repeat for all the input and output controls that are to be associated to the 
terminals. For the Fibonacci.vi, [link] shows the right connector terminal 
associated with the Fib(n) output terminal. 


Connected 
Terminals 


Icon Editor 


Right click on the connector pane and select Edit Icon... from the pop-up 
menu. This will bring the icon editor ({link]). 


Edit the icon for black and white, 16-color and 256-color displays and click 
OK when completed. 


Save the G program to complete the function. 
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Icon Editor 


Invoking Functions 


To invoke functions, right click on the Block Diagram window and select 
Select a VI... from the pop-up menu. This will bring a file dialog box. Find 


the desired function to be part of the program and click OK. 


Functions 


Select a VI... 


Invoking Functions 


In the example shown in [link], the Fibonacci series of the first 20 
Fibonacci numbers is stored in an array. The numbers are computed by 
invoking the Fibonacci.vi function. 


Fibonacci 
Series 


Graphs 
The creation of this content was supported in some part by NSF grant 
0538934. 


Waveform Chart 


Waveform Charts provide a historical graphical representation of numeric 
data. 


The following example will build a simple G program that will allow you to 
chart a sine wave as it is being generated on a point-by-point basis using the 
equation: 

Equation: 


y; =sin (0.227) 
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Waveform Chart 


Start with a while loop and add into it a Multiply and Sine functions, a 
numeric constant with value 0.2 and a Boolean control to stop the loop 
when its value is True. Arrange the diagram to look as in [link]. 


While Loop 
For Waveform 
Chart 


To select a waveform chart, right click on the Front Panel window and 
select Waveform Chart from the Controls >> Modern >> Graph menu. 


Waveform Chart 
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Selecting Waveform Chart 


This places the Waveform Chart in the Front Panel window. 
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Waveform Chart in Front Panel 
window 


In the Block Diagram window, make sure that the Waveform Chart terminal 
is inside the while loop. Wire the output of the Sine function to this 


terminal. 


Notice that Waveform Chart terminal is that of a numeric output. 


Waveform 
Chart 
Terminal 


Most modern computers will run this program too fast. Thus, before this 
program is executed, a delay of 125 milliseconds will be inserted in the 
while loop. This will allow users to see how the Waveform Chart operates 
as data samples are plotted in the chard. 


From the Functions >> Programming >> Timing select Wait Until Next 
ms Multiple. This will put the while loop to sleep for the indicated number 
of milliseconds. 
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Wait Until Next ms Multiple 


Drop the Wait Until Next ms Multiple function inside the loop and wire a 
constant to it with the value 125. This will delay the loop for 125 
milliseconds. The final Waveform Chart program is shown in [Link]. 


Waveform 
Chart Program 


The default graphing mode of the Waveform Chart is autoscaling. You will 
notice the auto-scaling property when the program first begins to run and 
the y-axis, labeled Amplitude, updates automatically as new numerical 
values are aggregated and displayed on the chart. 


Waveform Chart Plot 0 WJ | 
1 - 


0.6- 


= 
an 
i 


Amplitude 


a 
- 
i 


| 
0 100 
Time 


Waveform Chart Autoscaling 


As the program continues to run, the graph continues to build as per the 
values associated with the x-axis, labeled Time, which correspond to the 


index value of the equations. 
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Accumulating Values for the 
Waveform Chart 


As the program continues to run, the autoscaling property also applies to the 
x-axis. Noticed the updated x-axis. For this example, the x-axis will 
continue updating so as long as the program is running. This gives the 
appearance of a scrolling strip chart. 
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Scrolling X-Axis 


Stopping and restarting the G program retains the numeric history and 
continues to aggregate the values for display. 


Waveform Chart Plot 0 IW 5 
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Graph History Retained Between 
Runs 


The Waveform Chart options can be easily updated by right clicking on the 
Waveform Chart and selecting the appropriate option to update from the 


pop-up menu. 


Selecting Properties from this pop-up menu brings up the Waveform Chart 
dialog window ({link]). 
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Waveform Chart Pop-Up Menu 
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Waveform Chart Options Dialog Box 


Waveform Graph 


The Waveform Graph allows numeric arrays to be displayed graphically 
in the Front Panel window. 


Similar to the previous example, we will build a simple G program that will 
allow you to graph a sine wave using the equation: 
Equation: 


y; =sin (0.2 x 1) 


for i=0, 1, 2, ... , 99. 
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Waveform Graph 


Single Plot 


Start by building the following program shown in [link]. 


For Loop 
Sine Wave 


Right click on the Front Panel window, select Waveform Graph from the 
Modern >> Graph pop-up menu, and drop it on the Front Panel window. 
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Select Waveform Graph 


In the Block Diagram window you will see the Waveform Graph terminal. 
Wire the Sine function output to the Waveform Graph terminal through 
the For Loop. 


Waveform 
Graph 


Waveform Graph 
Diagram 


Run the program. The resulting graph is shown in [link]. 
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Multiplots 


In this example a sine wave and a noisy sine wave will be plotted. Modify 
the previous example to add noise to the sine operation as shown in [link]. 


Sine and Noisy 
Sine Waveforms 


Add a Build Array operator and wire the output of the Sine function and 
the multi-add operator containing the sine value plus some random noise 


between -0.5 and 0.5 to the Build Array operator. Wire the output of the 
Build Array operator to the Waveform Graph terminal. 


Waveform 
Graph 


Bundle Arrays for Multiplotting 


You can continue adding 1D arrays to be multiplotted into a single 
Waveform Graph. 


Run the program. The multiplot result is shown in [Link]. 
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XY Graph 


The XY Graph plots x vs. y numeric values contained in arrays. 
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XY Graph 


The example shown in [link] generates the spiral shown in [link]. 


Spiral G Program 


Interactive Programming 
The creation of this content was supported in some part by NSF grant 
0538934. 


The heart of interactive programming in G is the while loop. Any input 
control within the while loop can be modified from the Front Panel window 
at run time to provide seamless interaction with the G program. 


G Program 
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In the Front Panel window, from the Functions >> Modern >> Numeric 
select the vertical pointer slide. From the Functions >> Modern >> Graph 
select Waveform Chart. 
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Vertical Pointer Slide and 
Waveform Chart 


Re-label the vertical pointer slide as Amplitude and the waveform chart as 
Sine Wave. Re-arrange to GUI to look like the figure below. 
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Right click on Sine Wave and select Properties from the pop-up menu. 
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Selecting Chart Properties 


Select the Scales tab and change Maximum to 1023. Sine Wave will 
display 1024 samples. 
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Click on the down arrow located to the right of Time (X-Axis) and select 
Amplitude (Y-Axis). 
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Selecting Y-Axis 


De-select Autoscale and change the Minimum and Maximum values to 
-10 and 10. Click OK. 
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De-Selecting Autoscale 


Rearrange Amplitude and Sine Wave terminals and finish the program as 
shown in [link]. 


Scroll the mouse pointer over the Loop Control... 
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Loop Condition 


And right click on the Loop Control and from the pop-up menu select 
Create Control. 


A stop terminal is created. 
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With the corresponding stop Boolean input control. Save the G program as 
Interactivity.vi. 
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Run the G program. 
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Interactive Program 


While the program is running, change the Amplitude and watch the graph 
update to reflect the interactive changes. 
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Interactive Program 


To end the G program, simply click on the stop button. 
Plot 0 gee | 
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Congratulations. You have successfully completed and executed your first 
interactive G program. 


Parallel Programming 
The creation of this content was supported in some part by NSF grant 
0538934. 


In 1985, by design, G was developed to address and simplify parallel 
programming. If you have gone through the examples in this book, you 
have already developed various parallel programs. 


In the following example, we will develop a simple program where 
interactivity and parallelism are part of the program. 
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From the menu select Edit >> Copy. 
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Copy Selected Diagram 


Create a copy of the while loop and its contents by selecting Edit >> Paste. 
Organize the diagram as shown in the figure below. 


Sine Wave 2 


Paste Diagram 


Go the Front Panel window and organize the input and output controls as 
shown in the figure below. 
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You have just completed your first parallel interactive program using G. 
Save the program, run it and interact with it. 
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To end this program click on the stop and stop 2 terminals. 


Multicore Programming 


The creation of this content was supported in some part by NSF grant 
0538934. 


If you have written parallel programs in G and have a multicore computer, 
CONGRATULATIONS!!! You have been successfully developing 


interactive parallel programs that execute in multicore PC processors. 
Amplitude Sine Wave PlotO Fae 


| amplitude 2 Sine Wave 2 Plot (aa 


Amplitude 
Amplitude 


sili 1 
SPLF771F 37178740 
Time Time 


-10=; 1 
60923353 60924376 


CPU Usage CPU Usage History 


Interactive Multicore G Program 


The following sections discuss some multicore programming techniques to 
improve the performance of G programs. 


Data Parallelism 


Matrix multiplication is a compute intensive operation that can leverage 
data parallelism. [link] shows a G program with 8 sequential frames to 
demonstrate the performance improvement via data parallelism. 
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Data Parallelism 


The Create Matrix function generates a square matrix based of size 
indicated by Size containing random numbers between 0 and 1. The Create 
Matrix function is shown in [link]. 


Creating a Square 
Matrix 


The Split Matrix function determines the number of rows in the matrix and 
shifts right the resulting number of rows by one (integer divide by 2). This 
value is used to split the input matrix into the top half and bottom half 
matrices. The Split Matrix function is shown in [link]. 
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Records stop time of single core matrix multiply 
Frame 
Fifth Frame Splits the matrix into top and bottom matrices 
Sixth Frame Records start time for multicore matrix multiply 
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Performs multicore matrix multiply 
Frame 
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Frame Operation Description 


Eighth 


Records stop time of multicore matrix multiply 
Frame 


The rest of the calculations determine the execution time in milliseconds of 
the single core and multicore matrix multiply operations and the 
performance improvement of using data parallelism in a multicore 
computer. 


The program was executed in a dual core 1.83 GHz laptop. The results are 
shown in [link]. By leveraging data parallelism, the same operation has 
nearly a 2x performance improvement. Similar performance benefits can be 
obtained with higher multicore processors 


Data Parallelism 
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Task Pipelining 


A variety of applications require tasks to be programmed sequentially and 
continually iterate on these tasks. Most notably are telecommunications 
applications require simultaneous transmit and receive. In the following 
example, a simple telecommunications example illustrates how these 
sequential tasks can be pipelined to leverage multicore environments. 


Consider the following simple modulation - demodulation example where a 
noisy signal is modulated transmitted and demodulated. A typical diagram 
is shown in [link]. 


Sequential Tasks 


Adding a shift register to the loop allows tasks to be pipelined and be 
executed in parallel in separate cores should they be available. Task 
pipelining is shown in [link]. 


Pipelined Tasks 


The program below times the sequential task and the pipelined tasks to 
establish its performance improvement when executed in multicore 
computers. 
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Task Pipelining Program Example 


[link] shows the results of running the above G program in a dual core 1.8 
GHz laptop. Pipelining shows nearly 2x performance improvement. 
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Pipelining Using Feedback Nodes 


Feedback Nodes provide a storage mechanism between loop iterations. 
They are programmatically identical to the Shift Registers. Feedback 
Nodes consist of an Initializer Terminal and the Feedback Node itself 
(see [link]). 
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To add a Feedback Node, right click on the Block Diagram window and 
select Feedback Node from the Functions >> Programming >> 
Structures pop-up menu. The direction of the Feedback Node can be 
changed by right clicking on the node and selecting Change Direction. 
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The diagram shown in [link] is programmatically identical to the diagram in 
[link]. 
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Similarly, the diagram in [link] is programmatically identical to that in 
[link]. 
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Pipelining Tasks with Feedback Nodes 


Input and Output 
The creation of this content was supported in some part by NSF grant 
0538934. 


Writing to File 


Consider the function in [link] where a set of numbers in a one-dimensional 
array represents the resulting noisy signal is to be written to a file. This 
section will outline the steps required to create files. 


Noisy Signal Function 


Create a new G program, right click in the G programming window and 
select File Dialog from the Functions >> Programming >> File I/O >> 
Advanced Functions menu. Drag and drop the File Dialog function onto 
the G programming window. 
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File Dialog 


The Configure File Dialog dialog box automatically appears to configure 
the function. Accept the default configuration shown in [link] to create a 
single file by clicking the OK button. 


Configure File Dialog [File Dialog] 
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Configure File Dialog 


The resulting diagram after closing the configuration dialog box is shown in 
. Optionally, right click on File Dialog and select View As Icon from the 
pop-up menu. This will save some real estate in the G programming 
window. 
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From the Functions >> Programming >> File I/O menu select 
Open/Create File, Write Binary File and Close File functions. 
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Strip Path 


File Input and Output Operators 


Arrange the File I/O operations as shown in [link] 
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Open, Write and Close File Diagram 


Right click on the operation (0:open) terminal of the Open/Create File 
function (highlighted in [link]). 
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File Create Operation 


Select Create >> Constant from the pop-up menu. 
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Create Operation Constant 


Arrange the diagram to look as in [link]. 


File Dialog | 


Operation Constant 


Click on the down arrow in the operation constant just created and select 
open or create from the pop-up menu. 
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Open or Create File Operation 


The resulting updated operation constant value is shown in [link]. 
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Create File to Write 


Repeat the process to create a constant for the access (0:read/write) 
terminal (highlighted in [link]). 
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File Access Mode 


Set the constant to write-only. Re-arrange the block diagram to look like 
the diagram shown in [link]. At this point, the file is set to create a new file 
for writing. 
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Write Only Mode 


Get the Noisy Signal function and wire its output data to the Data terminal 
of the Write to Binary File function. 


Writing Binary Data 


Complete the diagram by connecting the Open, Write and Close file 
operations as shown in [link]. 


Writing to File G Program 


When this G program is executed, the standard file dialog box appears. 
Name the file to be written signal.dat. 
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Create File Dialog Box 


Once the program completes executing, the signal.dat file is created and 
located in the location indicated by the path selected. 
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Reading From Files 


The signal.dat file created in the previous example will be used to read data 
from a file. As in the previous example, select the File Dialog, 
Open/Create File, Read from Binary File and Close File functions. 


Operators to Read Files 


Create constants by right clicking on the operation (0:open) and access 
(0:read/write) terminals of the Open/Create File operation. Set the 
constants to open and read-only respectively (see [link] ). 
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Similar to creating arrays, drop an array constant in the G diagram, drop a 
numeric constant onto the array constant and set the data type 
representation to double. Wire this array constant to the data type terminal 
of the Read from Binary File function as shown in [link] . 


Data Type to Read 


In the Front Panel window, drop a Waveform Graph. 
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Graph for Data to be Read 


With the data type specified, wire the data terminal of the Read from 
Binary File function to the Waveform Graph terminal as shown in [link] . 


Data to be Read 


Complete the program by wiring refnum and error terminals of the 
Open/Create File, Read from Binary File and Close File functions as 
shown in [link] . 


Read Binary Data G Program 


When this program is executed, a file dialog box appears. Select the 
signal.dat file and click OK. 
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Save in: | © Chapter 11 - Input and Output 
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Select Binary File to Read From 


The binary data in signal.dat is read and plotted in a Waveform Graph. 
The result is shown in [link] 
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